home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / standard / polf.z / polf
Encoding:
Text File  |  1998-10-20  |  5.2 KB  |  133 lines

  1.  
  2.  
  3.  
  4. ppppoooollllffff((((3333GGGG))))                                                              ppppoooollllffff((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppoooollllffff,,,, ppppoooollllffffiiii,,,, ppppoooollllffffssss,,,, ppppoooollllffff2222,,,, ppppoooollllffff2222iiii,,,, ppppoooollllffff2222ssss - draws a filled polygon
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd ppppoooollllffff((((lllloooonnnngggg nnnn,,,, ccccoooonnnnsssstttt CCCCoooooooorrrrdddd ppppaaaarrrrrrrraaaayyyy[[[[]]]][[[[3333]]]]))))
  13.  
  14.      vvvvooooiiiidddd ppppoooollllffffiiii((((lllloooonnnngggg nnnn,,,, ccccoooonnnnsssstttt IIIIccccoooooooorrrrdddd ppppaaaarrrrrrrraaaayyyy[[[[]]]][[[[3333]]]]))))
  15.  
  16.      vvvvooooiiiidddd ppppoooollllffffssss((((lllloooonnnngggg nnnn,,,, ccccoooonnnnsssstttt SSSSccccoooooooorrrrdddd ppppaaaarrrrrrrraaaayyyy[[[[]]]][[[[3333]]]]))))
  17.  
  18.      vvvvooooiiiidddd ppppoooollllffff2222((((lllloooonnnngggg nnnn,,,, ccccoooonnnnsssstttt CCCCoooooooorrrrdddd ppppaaaarrrrrrrraaaayyyy[[[[]]]][[[[2222]]]]))))
  19.  
  20.      vvvvooooiiiidddd ppppoooollllffff2222iiii((((lllloooonnnngggg nnnn,,,, ccccoooonnnnsssstttt IIIIccccoooooooorrrrdddd ppppaaaarrrrrrrraaaayyyy[[[[]]]][[[[2222]]]]))))
  21.  
  22.      vvvvooooiiiidddd ppppoooollllffff2222ssss((((lllloooonnnngggg nnnn,,,, ccccoooonnnnsssstttt SSSSccccoooooooorrrrdddd ppppaaaarrrrrrrraaaayyyy[[[[]]]][[[[2222]]]]))))
  23.  
  24.      All of the above routines are functionally the same.  They differ only in
  25.      the declared type of their parameters and whether or not they assume a
  26.      two-dimensional or three-dimensional world.
  27.  
  28. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  29.      _n        expects the number of vertices in the polygon.
  30.  
  31.      _p_a_r_r_a_y   expects the array containing the vertices of the polygon.
  32.  
  33. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  34.      ppppoooollllffff fills the polygonal area bounded by the vertices specified in
  35.      _p_a_r_r_a_y.  The first and last vertices connect automatically to close a
  36.      polygon.  The vertices can be expressed as integers, shorts, or real
  37.      numbers, in 2-D or 3-D space.  2-D polygons are drawn with _z=0.  After
  38.      the polygon is filled, the current graphics position is set to the first
  39.      vertex in the array.
  40.  
  41.      Properties that affect the drawing of polygons include the current color,
  42.      writemask, fill pattern, shade model, polygon antialiasing mode, polygon
  43.      scan conversion mode, and subpixel mode.  Some polygon modes are
  44.      applicable only if old-style scan conversion is defeated.  (See note
  45.      below.)
  46.  
  47.      There can be no more than 256 vertices in a polygon. In addition, ppppoooollllffff
  48.      cannot correctly draw polygons that intersect themselves.
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      backface, bgnpolygon, concave, frontface, glcompat, poly, polymode,
  52.      polysmooth, scrsubdivide, setpattern, shademodel, subpixel
  53.  
  54. NNNNOOOOTTTTEEEE
  55.      By default ppppoooollllffff draws a polygon using the old-style scan conversion
  56.      algorithm, rather than the point sampling algorithm used by bbbbggggnnnnppppoooollllyyyyggggoooonnnn
  57.      and eeeennnnddddppppoooollllyyyyggggoooonnnn.  Point sampling is prefered over old-style scan
  58.      conversion because it has higher performance, it results in higher-
  59.      quality images when blending, logical operations, or stenciling are used,
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppoooollllffff((((3333GGGG))))                                                              ppppoooollllffff((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      and it supports new rendering features such as texture mapping, fog, and
  75.      antialiasing.  Call ggggllllccccoooommmmppppaaaatttt((((GGGGLLLLCCCC____OOOOLLLLDDDDPPPPOOOOLLLLYYYYGGGGOOOONNNN,,,,0000)))) to enable point sampling
  76.      of polygons generated by ppppoooollllffff.
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.